﻿<!DOCTYPE HTML>
<html lang="zh">
<head>
<title>激活窗口 - 语法 &amp; 使用 | AutoHotkey v2</title>
<meta name="description" content="The 激活窗口 function activates the specified window." />
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<link href="../static/theme.css" rel="stylesheet" type="text/css" />
<script src="../static/content.js" type="text/javascript"></script>
<script type="text/javascript">$(function(){0<=window.navigator.userAgent.toLowerCase().indexOf("ucbrowser")&&CaoNiMaDeUc()})</script>
</head>
<body>

<h1>激活窗口</h1>

<p>激活指定的窗口.</p>

<pre class="Syntax"><span class="func">激活窗口</span> <span class="optional">WinTitle, WinText, ExcludeTitle, ExcludeText</span></pre>
<h2 id="Parameters">参数</h2>
<dl>

  <dt>WinTitle</dt>
  <dd>
    <p>类型: <a href="../Concepts.htm#strings">字符串</a>, <a href="../Concepts.htm#numbers">整数</a>或<a href="../Objects.htm">对象</a></p>
    <p>识别目标窗口的窗口标题或其他条件. 请参阅 <a href="../misc/WinTitle.htm">WinTitle</a>.</p>
  </dd>

  <dt>WinText</dt>
  <dd>
    <p>类型: <a href="../Concepts.htm#strings">字符串</a></p>
    <p>如果存在, 此参数必须是目标窗口的单个文本元素的子字符串(和内置的 Window Spy 工具显示的一样). 如果 <a href="DetectHiddenText.htm">检测隐藏文本</a> 为 ON, 那么会检测隐藏文本元素.</p>
  </dd>

  <dt>ExcludeTitle</dt>
  <dd>
    <p>类型: <a href="../Concepts.htm#strings">字符串</a></p>
    <p>标题中含有此参数值的窗口将被排除.</p>
  </dd>

  <dt>ExcludeText</dt>
  <dd>
    <p>类型: <a href="../Concepts.htm#strings">字符串</a></p>
    <p>文本中含有此参数值的窗口将被排除.</p>
  </dd>

</dl>

<h2 id="Remarks">备注</h2>
<p>当非活动窗口变为活动状态时, 操作系统也会使其处于最前面(将其带到堆栈的顶部). 如果窗口已经处于活动状态, 则不会发生这种情况.</p>
<p>如果窗口处于最小化和非活动状态, 那么会对其还原后再进行激活. 如果 <em>WinTitle</em> 是字母 "A", 并且省略了其他参数, 则活动窗口将会还原. 窗口即使已经是活动窗口, 也会被还原.</p>
<p>在 60ms 的时间中, 会对目标窗口进行六次激活的尝试. 如果六次尝试都失败了, 激活窗口 会自动发送 <code>{Alt 2}</code> 作为操作系统可能实施的限制的变通方法, 然后进行第七次尝试. 因此, 通常不需要在此函数后使用 <a href="WinWaitActive.htm">等待窗口激活</a> 或 <code>如果 not <a href="WinActive.htm">窗口已激活</a>(...)</code>.</p>
<p>激活窗口 第一次尝试失败后, 会自动发送 <code>{Alt up}</code>. 测试表明, 这可能会提高所有后续尝试的可靠性, 减少第一次尝试失败并导致任务栏按钮闪烁的情况. 在每个脚本的生命周期中, 为此目的发送的 <code>{Alt up}</code> 不超过一个. 如果这个或任何其他 (AutoHotkey v1.1.27+) 脚本安装了键盘钩子, <code>{Alt up}</code> 就会被阻挡在活动窗口之外, 从而将已经很小的副作用风险降到最低.</p>
<p>通常, 如果有多个窗口匹配, 则会激活最上面的匹配窗口(通常是最近使用的窗口). 如果窗口已经激活, 则它将保持激活状态, 而不是激活它下面的任何其他匹配窗口. 但是, 如果使用 <a href="WinMoveBottom.htm">置底窗口</a>, 将活动窗口移动到堆栈底部, 则可能会激活其他窗口, 即使活动窗口是匹配的.</p>
<p><a href="WinActivateBottom.htm">激活底层窗口</a> 激活最底层的匹配窗口(通常是最近最早使用的那个).</p>
<p><a href="GroupActivate.htm">激活窗口组</a> 激活与窗口组指定的条件匹配的下一个窗口.</p>
<p>如果要激活的窗口处于隐藏状态并且 <a href="DetectHiddenWindows.htm">检测隐藏窗口</a> 被设置为 OFF 时, 该窗口将永远不会视为一个匹配项. 相反, 只要有一个匹配窗口是可见的, 它就会被激活.</p>
<p>在激活另一个窗口后立即激活一个窗口时, 任务栏按钮可能在某些系统上可能会闪烁(取决于操作系统和设置). 为防止这种情况, 请使用 <a href="_WinActivateForce.htm">#强制激活窗口</a>.</p>
<p>窗口标题和文本是区分大小写的. 除非 <a href="DetectHiddenWindows.htm">检测隐藏窗口</a> 被打开, 否则不会检测隐藏窗口.</p>
<p><strong>已知问题:</strong> 如果脚本运行在正在被远程桌面访问的计算机或服务器上, 当远程桌面客户端最小化时, 激活窗口 可能会挂起. 一种解决办法是使用不需要激活窗口的内置函数, 如 <a href="ControlSend.htm">发送操作到控件</a> 和 <a href="ControlClick.htm">点击控件</a>. 另一个可能的解决方法是在本地/客户端计算机的注册表上做如下设置:</p>
<pre><em>; 将 HKCU 改成 HKLM, 以对该系统上的所有用户生效.</em>
写注册表 "REG_DWORD", "HKCU\Software\Microsoft\Terminal Server Client"
    , "RemoteDesktop_SuppressWhenMinimized", 2</pre>

<h2 id="Related">相关</h2>
<p><a href="WinActivateBottom.htm">激活底层窗口</a>, <a href="_WinActivateForce.htm">#强制激活窗口</a>, <a href="SetTitleMatchMode.htm">设置标题匹配模式</a>, <a href="DetectHiddenWindows.htm">检测隐藏窗口</a>, <a href="../misc/WinTitle.htm#LastFoundWindow">Last Found Window</a>, <a href="WinExist.htm">窗口存在</a>, <a href="WinActive.htm">窗口已激活</a>, <a href="WinWaitActive.htm">等待窗口激活</a>, <a href="WinWait.htm">等待窗口</a>, <a href="WinWaitClose.htm">等待窗口关闭</a>, <a href="WinClose.htm">关闭窗口</a>, <a href="GroupActivate.htm">激活窗口组</a>, <a href="Win.htm">Win 函数</a></p>
<h2 id="Examples">示例</h2>
<div class="ex" id="ExBasic">
<p><a href="#ExBasic">#1</a></p>
<pre>如果 窗口存在("无标题 - 记事本")
    激活窗口 <em>; 使用前面找到的窗口</em>
否则
    激活窗口 "Calculator"</pre>
</div>

</body>
</html>